home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1998 January: Mac OS SDK / Dev.CD Jan 98 SDK1.toast / Development Kits (Disc 1) / Interfaces&Libraries / Universal / Interfaces / AIncludes / QD3DPick.a < prev    next >
Encoding:
Text File  |  1997-08-12  |  10.7 KB  |  376 lines  |  [TEXT/MPS ]
  1. ;
  2. ;    File:        QD3DPick.a
  3. ;
  4. ;    Contains:    Q3Pick methods                                    
  5. ;
  6. ;    Version:    Technology:    Quickdraw 3D 1.5.1
  7. ;                Release:    Universal Interfaces 3.0.1
  8. ;
  9. ;    Copyright:    © 1995-1997 by Apple Computer, Inc., all rights reserved.
  10. ;
  11. ;    Bugs?:        Please include the the file and version information (from above) with
  12. ;                the problem description.  Developers belonging to one of the Apple
  13. ;                developer programs can submit bug reports to:
  14. ;
  15. ;                    devsupport@apple.com
  16. ;
  17. ;
  18.     IF &TYPE('__QD3DPICK__') = 'UNDEFINED' THEN
  19. __QD3DPICK__ SET 1
  20.  
  21.     IF &TYPE('__QD3D__') = 'UNDEFINED' THEN
  22.     include 'QD3D.a'
  23.     ENDIF
  24.  
  25.     IF &TYPE('__QD3DSTYLE__') = 'UNDEFINED' THEN
  26.     include 'QD3DStyle.a'
  27.     ENDIF
  28.     IF &TYPE('__QD3DGEOMETRY__') = 'UNDEFINED' THEN
  29.     include 'QD3DGeometry.a'
  30.     ENDIF
  31.  
  32. ; *****************************************************************************
  33. ; **                                                                            **
  34. ; **                            Mask bits for hit information                     **
  35. ; **                                                                            **
  36. ; ****************************************************************************
  37.  
  38.  
  39. ; typedef long                            TQ3PickDetailMasks
  40. kQ3PickDetailNone                EQU        0
  41. kQ3PickDetailMaskPickID            EQU        $01
  42. kQ3PickDetailMaskPath            EQU        $02
  43. kQ3PickDetailMaskObject            EQU        $04
  44. kQ3PickDetailMaskLocalToWorldMatrix EQU    $08
  45. kQ3PickDetailMaskXYZ            EQU        $10
  46. kQ3PickDetailMaskDistance        EQU        $20
  47. kQ3PickDetailMaskNormal            EQU        $40
  48. kQ3PickDetailMaskShapePart        EQU        $80
  49. kQ3PickDetailMaskPickPart        EQU        $0100
  50. kQ3PickDetailMaskUV                EQU        $0200
  51. ; typedef unsigned long                 TQ3PickDetail
  52.  
  53. ; ******************************************************************************
  54. ; **                                                                             **
  55. ; **                                Hitlist sorting                                 **
  56. ; **                                                                             **
  57. ; ****************************************************************************
  58.  
  59.  
  60. ; typedef long                            TQ3PickSort
  61. kQ3PickSortNone                    EQU        0
  62. kQ3PickSortNearToFar            EQU        1
  63. kQ3PickSortFarToNear            EQU        2
  64.  
  65. ; ******************************************************************************
  66. ; **                                                                             **
  67. ; **                    Data structures to set up the pick object                 **
  68. ; **                                                                             **
  69. ; ****************************************************************************
  70.  
  71. TQ3PickData                RECORD 0
  72. sort                     ds.l    1                ; offset: $0 (0)
  73. mask                     ds.l    1                ; offset: $4 (4)
  74. numHitsToReturn             ds.l    1                ; offset: $8 (8)
  75. sizeof                     EQU *                    ; size:   $C (12)
  76.                         ENDR
  77. TQ3WindowPointPickData    RECORD 0
  78. data                     ds        TQ3PickData        ; offset: $0 (0)
  79. point                     ds        TQ3Point2D        ; offset: $C (12)
  80. vertexTolerance             ds        Float32            ; offset: $14 (20)
  81. edgeTolerance             ds        Float32            ; offset: $18 (24)
  82. sizeof                     EQU *                    ; size:   $1C (28)
  83.                         ENDR
  84. TQ3WindowRectPickData    RECORD 0
  85. data                     ds        TQ3PickData        ; offset: $0 (0)
  86. rect                     ds        TQ3Area            ; offset: $C (12)
  87. sizeof                     EQU *                    ; size:   $1C (28)
  88.                         ENDR
  89. ; ******************************************************************************
  90. ; **                                                                             **
  91. ; **                                    Hit data                                 **
  92. ; **                                                                             **
  93. ; ****************************************************************************
  94.  
  95. TQ3HitPath                RECORD 0
  96. rootGroup                 ds.l    1                ; offset: $0 (0)
  97. depth                     ds.l    1                ; offset: $4 (4)
  98. positions                 ds.l    1                ; offset: $8 (8)
  99. sizeof                     EQU *                    ; size:   $C (12)
  100.                         ENDR
  101. ; 
  102. ; *    The following data structure has been obsoleted by
  103. ; *    the Q3Pick_GetPickDetailData function in conjunction
  104. ; *    with the pickDetailValue enum
  105. ; 
  106.  
  107. TQ3HitData                RECORD 0
  108. part                     ds.l    1                ; offset: $0 (0)
  109. validMask                 ds.l    1                ; offset: $4 (4)
  110. pickID                     ds.l    1                ; offset: $8 (8)
  111. path                     ds        TQ3HitPath        ; offset: $C (12)
  112. object                     ds.l    1                ; offset: $18 (24)
  113. localToWorldMatrix         ds        TQ3Matrix4x4    ; offset: $1C (28)
  114. xyzPoint                 ds        TQ3Point3D        ; offset: $5C (92)
  115. distance                 ds        Float32            ; offset: $68 (104)
  116. normal                     ds        TQ3Vector3D        ; offset: $6C (108)
  117. shapePart                 ds.l    1                ; offset: $78 (120)
  118. sizeof                     EQU *                    ; size:   $7C (124)
  119.                         ENDR
  120. ; ******************************************************************************
  121. ; **                                                                             **
  122. ; **                                Pick class methods                             **
  123. ; **                                                                             **
  124. ; ****************************************************************************
  125.  
  126. ;
  127. ; extern TQ3ObjectType Q3Pick_GetType(TQ3PickObject pick)
  128. ;
  129.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  130.         IMPORT_CFM_FUNCTION Q3Pick_GetType
  131.     ENDIF
  132.  
  133. ;
  134. ; extern TQ3Status Q3Pick_GetData(TQ3PickObject pick, TQ3PickData *data)
  135. ;
  136.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  137.         IMPORT_CFM_FUNCTION Q3Pick_GetData
  138.     ENDIF
  139.  
  140. ;
  141. ; extern TQ3Status Q3Pick_SetData(TQ3PickObject pick, const TQ3PickData *data)
  142. ;
  143.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  144.         IMPORT_CFM_FUNCTION Q3Pick_SetData
  145.     ENDIF
  146.  
  147. ;
  148. ; extern TQ3Status Q3Pick_GetVertexTolerance(TQ3PickObject pick, float *vertexTolerance)
  149. ;
  150.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  151.         IMPORT_CFM_FUNCTION Q3Pick_GetVertexTolerance
  152.     ENDIF
  153.  
  154. ;
  155. ; extern TQ3Status Q3Pick_GetEdgeTolerance(TQ3PickObject pick, float *edgeTolerance)
  156. ;
  157.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  158.         IMPORT_CFM_FUNCTION Q3Pick_GetEdgeTolerance
  159.     ENDIF
  160.  
  161. ;
  162. ; extern TQ3Status Q3Pick_SetVertexTolerance(TQ3PickObject pick, float vertexTolerance)
  163. ;
  164.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  165.         IMPORT_CFM_FUNCTION Q3Pick_SetVertexTolerance
  166.     ENDIF
  167.  
  168. ;
  169. ; extern TQ3Status Q3Pick_SetEdgeTolerance(TQ3PickObject pick, float edgeTolerance)
  170. ;
  171.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  172.         IMPORT_CFM_FUNCTION Q3Pick_SetEdgeTolerance
  173.     ENDIF
  174.  
  175. ;
  176. ; extern TQ3Status Q3Pick_GetNumHits(TQ3PickObject pick, unsigned long *numHits)
  177. ;
  178.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  179.         IMPORT_CFM_FUNCTION Q3Pick_GetNumHits
  180.     ENDIF
  181.  
  182. ;
  183. ; extern TQ3Status Q3Pick_EmptyHitList(TQ3PickObject pick)
  184. ;
  185.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  186.         IMPORT_CFM_FUNCTION Q3Pick_EmptyHitList
  187.     ENDIF
  188.  
  189. ;
  190. ; extern TQ3Status Q3Pick_GetPickDetailValidMask(TQ3PickObject pick, unsigned long index, TQ3PickDetail *pickDetailValidMask)
  191. ;
  192.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  193.         IMPORT_CFM_FUNCTION Q3Pick_GetPickDetailValidMask
  194.     ENDIF
  195.  
  196. ;
  197. ; extern TQ3Status Q3Pick_GetPickDetailData(TQ3PickObject pick, unsigned long index, TQ3PickDetail pickDetailValue, void *detailData)
  198. ;
  199.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  200.         IMPORT_CFM_FUNCTION Q3Pick_GetPickDetailData
  201.     ENDIF
  202.  
  203. ;
  204. ; extern TQ3Status Q3HitPath_EmptyData(TQ3HitPath *hitPath)
  205. ;
  206.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  207.         IMPORT_CFM_FUNCTION Q3HitPath_EmptyData
  208.     ENDIF
  209.  
  210.  
  211. ; 
  212. ; *    The following functions have been superseeded
  213. ; *    by the Q3Pick_GetPickDetailData function
  214. ; 
  215.  
  216. ;
  217. ; extern TQ3Status Q3Pick_GetHitData(TQ3PickObject pick, unsigned long index, TQ3HitData *hitData)
  218. ;
  219.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  220.         IMPORT_CFM_FUNCTION Q3Pick_GetHitData
  221.     ENDIF
  222.  
  223. ;
  224. ; extern TQ3Status Q3Hit_EmptyData(TQ3HitData *hitData)
  225. ;
  226.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  227.         IMPORT_CFM_FUNCTION Q3Hit_EmptyData
  228.     ENDIF
  229.  
  230.  
  231.  
  232. ; ******************************************************************************
  233. ; **                                                                             **
  234. ; **                            Window point pick methods                         **
  235. ; **                                                                             **
  236. ; ****************************************************************************
  237.  
  238. ;
  239. ; extern TQ3PickObject Q3WindowPointPick_New(const TQ3WindowPointPickData *data)
  240. ;
  241.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  242.         IMPORT_CFM_FUNCTION Q3WindowPointPick_New
  243.     ENDIF
  244.  
  245. ;
  246. ; extern TQ3Status Q3WindowPointPick_GetPoint(TQ3PickObject pick, TQ3Point2D *point)
  247. ;
  248.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  249.         IMPORT_CFM_FUNCTION Q3WindowPointPick_GetPoint
  250.     ENDIF
  251.  
  252. ;
  253. ; extern TQ3Status Q3WindowPointPick_SetPoint(TQ3PickObject pick, const TQ3Point2D *point)
  254. ;
  255.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  256.         IMPORT_CFM_FUNCTION Q3WindowPointPick_SetPoint
  257.     ENDIF
  258.  
  259. ;
  260. ; extern TQ3Status Q3WindowPointPick_GetData(TQ3PickObject pick, TQ3WindowPointPickData *data)
  261. ;
  262.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  263.         IMPORT_CFM_FUNCTION Q3WindowPointPick_GetData
  264.     ENDIF
  265.  
  266. ;
  267. ; extern TQ3Status Q3WindowPointPick_SetData(TQ3PickObject pick, const TQ3WindowPointPickData *data)
  268. ;
  269.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  270.         IMPORT_CFM_FUNCTION Q3WindowPointPick_SetData
  271.     ENDIF
  272.  
  273.  
  274. ; ******************************************************************************
  275. ; **                                                                             **
  276. ; **                            Window rect pick methods                         **
  277. ; **                                                                             **
  278. ; ****************************************************************************
  279.  
  280. ;
  281. ; extern TQ3PickObject Q3WindowRectPick_New(const TQ3WindowRectPickData *data)
  282. ;
  283.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  284.         IMPORT_CFM_FUNCTION Q3WindowRectPick_New
  285.     ENDIF
  286.  
  287. ;
  288. ; extern TQ3Status Q3WindowRectPick_GetRect(TQ3PickObject pick, TQ3Area *rect)
  289. ;
  290.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  291.         IMPORT_CFM_FUNCTION Q3WindowRectPick_GetRect
  292.     ENDIF
  293.  
  294. ;
  295. ; extern TQ3Status Q3WindowRectPick_SetRect(TQ3PickObject pick, const TQ3Area *rect)
  296. ;
  297.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  298.         IMPORT_CFM_FUNCTION Q3WindowRectPick_SetRect
  299.     ENDIF
  300.  
  301. ;
  302. ; extern TQ3Status Q3WindowRectPick_GetData(TQ3PickObject pick, TQ3WindowRectPickData *data)
  303. ;
  304.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  305.         IMPORT_CFM_FUNCTION Q3WindowRectPick_GetData
  306.     ENDIF
  307.  
  308. ;
  309. ; extern TQ3Status Q3WindowRectPick_SetData(TQ3PickObject pick, const TQ3WindowRectPickData *data)
  310. ;
  311.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  312.         IMPORT_CFM_FUNCTION Q3WindowRectPick_SetData
  313.     ENDIF
  314.  
  315.  
  316.  
  317. ; ******************************************************************************
  318. ; **                                                                             **
  319. ; **                                Shape Part methods                             **
  320. ; **                                                                             **
  321. ; ****************************************************************************
  322.  
  323. ;
  324. ; extern TQ3ObjectType Q3ShapePart_GetType(TQ3ShapePartObject shapePartObject)
  325. ;
  326.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  327.         IMPORT_CFM_FUNCTION Q3ShapePart_GetType
  328.     ENDIF
  329.  
  330. ;
  331. ; extern TQ3ObjectType Q3MeshPart_GetType(TQ3MeshPartObject meshPartObject)
  332. ;
  333.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  334.         IMPORT_CFM_FUNCTION Q3MeshPart_GetType
  335.     ENDIF
  336.  
  337. ;
  338. ; extern TQ3Status Q3ShapePart_GetShape(TQ3ShapePartObject shapePartObject, TQ3ShapeObject *shapeObject)
  339. ;
  340.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  341.         IMPORT_CFM_FUNCTION Q3ShapePart_GetShape
  342.     ENDIF
  343.  
  344. ;
  345. ; extern TQ3Status Q3MeshPart_GetComponent(TQ3MeshPartObject meshPartObject, TQ3MeshComponent *component)
  346. ;
  347.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  348.         IMPORT_CFM_FUNCTION Q3MeshPart_GetComponent
  349.     ENDIF
  350.  
  351. ;
  352. ; extern TQ3Status Q3MeshFacePart_GetFace(TQ3MeshFacePartObject meshFacePartObject, TQ3MeshFace *face)
  353. ;
  354.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  355.         IMPORT_CFM_FUNCTION Q3MeshFacePart_GetFace
  356.     ENDIF
  357.  
  358. ;
  359. ; extern TQ3Status Q3MeshEdgePart_GetEdge(TQ3MeshEdgePartObject meshEdgePartObject, TQ3MeshEdge *edge)
  360. ;
  361.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  362.         IMPORT_CFM_FUNCTION Q3MeshEdgePart_GetEdge
  363.     ENDIF
  364.  
  365. ;
  366. ; extern TQ3Status Q3MeshVertexPart_GetVertex(TQ3MeshVertexPartObject meshVertexPartObject, TQ3MeshVertex *vertex)
  367. ;
  368.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  369.         IMPORT_CFM_FUNCTION Q3MeshVertexPart_GetVertex
  370.     ENDIF
  371.  
  372.  
  373.  
  374.     ENDIF ; __QD3DPICK__ 
  375.  
  376.